Closes #1889

Hard failures

hyde-shell themeswitch did not exist. themeswitch.sh was deleted by 6eb07e2d and Scripts/migrations/v26.7.4.sh:35 retires the leftover, and hyde-shell has no alias table — run_command tries .lua, .sh, .py, executable — so every call hard-failed. Repointed at theme.switch in Configs/.local/share/waybar/modules/custom-theme.jsonc, modules/custom-hyde-menu.jsonc, layouts/macos.jsonc, and at theme.switch.sh in Configs/.local/lib/hyde/wallpaper.kon.sh (reachable from Dolphin's "Set As Wallpaper", shipped by Scripts/dots/dolphin.toml:11-19).

The config editor created dead files. config-registry.toml offered hypr/{userprefs,keybindings,windowrules,nvidia}.conf, none of which anything loads. hydectl flags a missing entry in the list, but config.EditConfigFile runs ExpandPath → os.MkdirAll → $EDITOR without stat'ing the target, so accepting one created the directory and, on save, a file Hyprland never reads. The four entries collapse into one pointing at ${XDG_CONFIG_HOME}/hypr/hyprland.lua, which is where user overrides actually belong (Scripts/dots/hyprland.toml:23-27, preserve).

Environment variable

The deployed entry point is ${XDG_DATA_HOME}/hypr/hyde.lua (Scripts/dots/hyprland.toml:11-16). Configs/.config/fish/conf.d/hyde.fish:77 exported a .conf deleted by the Lua release, and Configs/.config/uwsm/env-hyprland.d/00-hyde.sh:28 defaulted to hypr/hyprland.lua, which no dot deploys. Fish now walks the same candidate list as shell/activate:49-61, and uwsm defaults to hyde.lua.

Both were scoped rather than fatal — 00-hyde.sh sources activate first, and activate resets HYPRLAND_CONFIG before setting it — so this bites the session that never activates, the case in discussion #1849, where the reporter quotes the fish line and the maintainer answers -c $XDG_DATA_HOME/hypr/hyde.lua. It also fed the "${HYPRLAND_CONFIG##*.}" == "lua" branches in theme.switch.sh:126-141, color.set.sh:7 and color/hypr.sh:208.

System monitor

system.monitor.sh:63, reachable from CTRL + SHIFT + ESCAPE, read the terminal out of the deleted ~/.config/hypr/keybindings.conf — and $term was first assigned on that very line, so the pattern was a bare ^\s* and the grep never meant anything even before the deletion. Removed. The documented fallback did not exist either: SYSMONITOR_TERMINAL appeared only in the script's show_help, so terminal is now declared in schema/config.toml and schema/schema.toml. With neither that nor TERMINAL set the script warns and moves to the next candidate instead of launching a console monitor with no terminal attached.

Dead code

hyde-launch.sh:6 called the deleted open.sh; it now calls hyde-shell open. Nothing in the tree invokes hyde-launch — a full grep finds only its own deprecation notice — so this is cosmetic; deleting the file instead would be equally correct.

keybinds_hint.sh:6-7 seeded kb_hint_conf from three deleted .conf paths and never read the variable again; ROFI_KEYBIND_HINT_CONFIG appears nowhere else. The hint reads live binds via keybinds/hint-hyprland.py, so the assignment and the two variables feeding it are gone. Note #1826 and #1775 also touch this file; the removed lines are not the ones they edit.

Deliberately not touched

globalcontrol.sh:335-340 and luautils/theme/parser.lua:134-141 still list ${XDG_DATA_HOME}/hyde/{hyde,hyprland}.conf among six default-config paths. Those two are no longer deployed, but the primary source $HYDE_THEME_DIR/hypr.theme still answers and the six-path grep is a last resort that now returns empty rather than failing — and a user may legitimately keep their own copy there. Left for a separate decision.

Configs/.local/lib/hyde/grimblast is referenced by nothing: screenshot.sh and screenrecord.sh both invoke $LIB_DIR/hyde/screenshot/grimblast, the vanilla copy the [grimblast] dot downloads. Worth noting because #1877 fixes the double selection in the in-repo file, which nothing runs — the live bug is in the downloaded script.

Tests

tests/test_references.sh (new) fails on the pre-change tree with 14 failures and passes after: it rejects any shipped config referencing hyde-shell themeswitch, themeswitch.sh, hyde/open.sh or the four retired hypr/*.conf paths, asserts the Lua entry point exists, and requires every shell integration that sets HYPRLAND_CONFIG to point at hypr/hyde.lua. The legacy Scripts/restore_cfg.* pair is out of scope, documented in the test.

Full suite: 9 cases, 0 failed.

Summary by CodeRabbit

• New Features

  • Added a configurable terminal setting for console system monitoring (sysmonitor.terminal), with documented fallback behavior.

• Bug Fixes

  • Updated theme switching across Waybar (menus/modules) and Dolphin/Wallpaper workflows to use the current theme.switch actions.
  • Improved Hyprland Lua config detection and ensured the config editor serves the real Lua files.
  • Fixed Fish sessions started outside UWSM failing due to removed/incorrect Lua config paths.
  • Prevented the system monitor from launching when no terminal is configured.

• Docs

  • Added an upgrade guide for migrating from the Lua-based hyprlang setup and refreshed keybinding reference links.

• Tests

  • Added a reference-check test to catch retired config filenames and validate Lua entry-point/config-path expectations.